home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / oglsnoop.z / oglsnoop
Text File  |  1998-10-20  |  10KB  |  199 lines
  1.  
  2.  
  3.  
  4. ooooggggllllssssnnnnoooooooopppp((((1111GGGG))))                                                      ooooggggllllssssnnnnoooooooopppp((((1111GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      oglsnoop - magnify and report on the screen under the mouse pointer
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ooooggggllllssssnnnnoooooooopppp
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _o_g_l_s_n_o_o_p is a program for viewing the color, depth and stencil values of
  16.      windows on the desktop. It displays these values graphically as well as
  17.      numerically in its window. _o_g_l_s_n_o_o_p can be used to determine the Visual
  18.      and Colormap that a given window is using. It can view both the Front and
  19.      Back buffers of Double Buffered windows and allows you to visualize the
  20.      Depth and Stencil Buffers using a grey scale display.
  21.  
  22.      _o_g_l_s_n_o_o_p has an Information dialog to view information about the window
  23.      currently being watched and an Advanced dialog for controlling the visual
  24.      mapping of depth values to grey scale color ranges. Most key information
  25.      is displayed in the _o_g_l_s_n_o_o_p title bar for quick reference.
  26.  
  27.      The _o_g_l_s_n_o_o_p title bar displays the following information....
  28.  
  29.           ZZZZoooooooommmm FFFFaaaaccccttttoooorrrr
  30.                     A number defining the magnification factor of the image.
  31.  
  32.           BBBBuuuuffffffffeeeerrrr TTTTyyyyppppeeee
  33.                     Color Index shows CI and True Color shows RGBA.
  34.  
  35.           SSSSiiiinnnngggglllleeee////DDDDoooouuuubbbblllleeee
  36.                     SINGLE for single buffered visuals and DOUBLE for double
  37.                     buffered ones.
  38.  
  39.           VVVViiiissssuuuuaaaallll IIIIDDDD Visual Id as a hexadecimal number. These equate to the
  40.                     numbers in glxinfo's output.
  41.  
  42.           CCCCuuuurrrrrrrreeeennnntttt BBBBuuuuffffffffeeeerrrr
  43.                     Blank indicates the Color buffer, D for Depth and S for
  44.                     Stencil.
  45.  
  46.           FFFFrrrroooonnnntttt////BBBBaaaacccckkkk
  47.                     F for the front buffer and B for back. If the current
  48.                     window isn't double buffered then nothing will be
  49.                     displayed here.
  50.  
  51.      In the bottom of the _o_g_l_s_n_o_o_p window is a bar that displays the values
  52.      for the current pixel. When _o_g_l_s_n_o_o_p is following the mouse then these
  53.      values represent the pixel at the current pointer position. When you have
  54.      grabbed a window then these values represent the pixel at the currently
  55.      grabbed window position. The represented values are X and Y coordinates,
  56.      Red Green Blue and Alpha color values in hex, Depth value in the range
  57.      0.0 -> 1.0, Stencil value in the range 0 -> maximum stencil value, and
  58.      the Color Index value. All values shown are for the current pixel. The X
  59.      and Y coordinates are relative to the Upper Left Corner of the display
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ooooggggllllssssnnnnoooooooopppp((((1111GGGG))))                                                      ooooggggllllssssnnnnoooooooopppp((((1111GGGG))))
  71.  
  72.  
  73.  
  74.      when in Normal Mode and the Lower Left Corner of the grabbed window when
  75.      in Grab Mode.
  76.  
  77.      The MMMMooooddddeeee menu contains a radio box for selecting the current buffer to
  78.      display.  Available choices are Color, Depth and Stencil. Although values
  79.      are read from all buffers at the current pixel position only one of the
  80.      buffers can be displayed visually at a time.
  81.  
  82.      The OOOOppppttttiiiioooonnnn menu contains controls that affect what is currently
  83.      displayed. The SSSSnnnnoooooooopppp toggle turns on/off the display of the current pixel
  84.      values. The AAAABBBBGGGGRRRR toggle reverses the display of color values from RGBA to
  85.      ABGR. The GGGGrrrriiiidddd toggle brings up a grid that is overlaid on the _o_g_l_s_n_o_o_p
  86.      window. This can be useful for counting pixels. The IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn............ button
  87.      brings up an Information dialog that displays more information about the
  88.      current window. The AAAAddddvvvvaaaannnncccceeeedddd............ button brings up an Advanced dialog that
  89.      allows you to modify the Depth and Stencil ranges being displayed.
  90.  
  91.      The Advanced dialog is only useful when viewing the Depth or Stencil
  92.      buffers. When you are viewing a Depth or Stencil buffer the range of
  93.      values is mapped to the color range to display grey scale equivalents of
  94.      the values. When the automatic toggles are set the ranges are calculated
  95.      on the fly. If the automatic toggle is not set then you can change the
  96.      way that depth or stencil values are mapped to color values. The Minimum
  97.      sliders control the percent of the available ranges that map to white
  98.      (ie. since Depth always ranges for 0.1 to 1.0 a Minimum Depth Setting of
  99.      90 would mean that depth values of 0.9 map to white ). The Maximum
  100.      sliders control the percent of the available ranges that map to black
  101.      (ie. a Maximum Depth setting of 100 would mean that depth values of 1.0
  102.      would map to black ). The scale is then linearly mapped from the Minimum
  103.      to the Maximum along the given color resolution. If the Minimum and
  104.      Maximum sliders are reversed (.ie Minimum is set to 100 and Maximum is
  105.      set to 90 ), then the grey scale values are reversed (ie. a Depth value
  106.      of 1.0 now maps to White and a Depth value of 0.9 maps to Black ) or Near
  107.      things are dark and far things are light.
  108.  
  109.      The VVVViiiieeeewwww menu contains controls that affect how information is read. The
  110.      ZZZZoooooooommmm++++++++ and ZZZZoooooooommmm-------- buttons increase and decrease the zoom factor by one
  111.      each time. The current zoom factor is displayed in the title bar. The
  112.      GGGGrrrraaaabbbb WWWWiiiinnnnddddoooowwww button activates the grab mechanism which allows you to
  113.      select a window to watch regardless of where the mouse pointer is. When
  114.      in Grab Mode if the mouse is placed over the _o_g_l_s_n_o_o_p window then you can
  115.      use the arrow keys to navigate around the currently grabbed window. The X
  116.      and Y coordinates displayed will be relative to the Lower Left Corner of
  117.      the grabbed window. To leave Grab Mode and go back to Normal Mode just
  118.      click on the Grab Window Button again ( it we be labeled as Ungrab Window
  119.      if you are in Grab Mode ). If _o_g_l_s_n_o_o_p is unable to grab a window
  120.      successfully it will remain in Normal Mode.  The last button on the VVVViiiieeeewwww
  121.      menu is the RRRReeeeaaaadddd BBBBaaaacccckkkk BBBBuuuuffffffffeeeerrrr button. When this toggle is set then the
  122.      back buffer is read instead of the front on double buffered windows.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ooooggggllllssssnnnnoooooooopppp((((1111GGGG))))                                                      ooooggggllllssssnnnnoooooooopppp((((1111GGGG))))
  137.  
  138.  
  139.  
  140.      Along with the menus most functions can be accessed with the keyboard.
  141.      The following is the list of keymappings...
  142.  
  143.           esc         quit
  144.  
  145.           1-9         set zoom factor
  146.  
  147.           0           set zoom factor to 10
  148.  
  149.           d           set zoom factor to 30
  150.  
  151.           m           go to next display mode (ie. Color -> Depth -> Stencil )
  152.  
  153.           b           toggle back buffer reading on/off
  154.  
  155.           g           grab/ungrab window
  156.  
  157.           s           toggle snoop mode
  158.  
  159.           r           reverse color display ABGR -> RGBA
  160.  
  161.           +           increase zoom factor by 1
  162.  
  163.           -           decrease zoom factor by 1
  164.  
  165.      The _o_g_l_s_n_o_o_p window can be resized to display a larger or smaller area.
  166.      When the _o_g_l_s_n_o_o_p window is not iconified it can use up to 30% of the
  167.      available cpu, so it might be wise to iconify it when you aren't using
  168.      it.
  169.  
  170. NNNNOOOOTTTTEEEESSSS
  171.      _o_g_l_s_n_o_o_p only views the top most window under the current mouse position.
  172.      Often this window is an overlay which is above the main graphics window.
  173.  
  174.      If a window is using a Visual which isn't OpenGL compatible then _o_g_l_s_n_o_o_p
  175.      will not be able to grab this window and likewise won't be able to read
  176.      depth, stencil or Color Index values from it.
  177.  
  178.      If a window is using a Visual that has Depth and Stencil buffers
  179.      associated with it then _o_g_l_s_n_o_o_p will display depth and stencil values
  180.      even though these values may be garbage.
  181.  
  182.      When first entering a window or after moving a grabbed window you may
  183.      need to cause the window to be redrawn for the proper values to be read
  184.      from the window.
  185.  
  186. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  187.      glxinfo(1g)
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.